Some housekeeping (again), installing necessary packages.

list.of.packages <- c("igraph", "tidygraph", "ggraph")
new.packages <- list.of.packages[!(list.of.packages %in% installed.packages()[,"Package"])]
if(length(new.packages)) install.packages(new.packages)
rm(list.of.packages, new.packages)

Introduction

Networks… So what?

So, before we talk about networks, one thing upfront… why should we? I mean, they undeniably look pretty, don’t they?

Somehow, the visualization of networks fascinates the human mind (find a short TED talk on networks and how they depict our world here), and has even inspired an own art movement, networkism (see some examples here).

Yet, besides that, is there an analytical value for a data scientist to bother about networks?

Networks in R

There are a number of applications designed for network analysis and the creation of network graphs such as gephi and cytoscape. Though not specifically designed for it, R has developed into a powerful tool for network analysis.

Significant network analysis packages for R include the network, sna, and igraph package. In addition, Thomas Lin Pedersen has recently released the tidygraph package that leverage the power of igraph in a manner consistent with the tidyverse workflow. Even better, he tops it up with ggraph, a consistent ´ggplot2´-look-and-feel network visualization package.

R can also be used to make interactive network graphs with the htmlwidgets framework that translates R code to JavaScript. Cool implementations thereof are the vizNetwork and networkD3 packages.

As analytical tool, I will in this lab mostly use igraph. In terms of functions, it is pretty much equivalent to network, yet slightly more powerful, better integrated, and maintained. Since both packages have many of the same functions, better don’t load them both at once.

The Basic Structure of Networks

The Basic Jargon

First of all, what is a network? Plainly speaking, a network is a system of elements which are connected by some relationship. The vocabulary can be a bit technical and even inconsistent between different disciplines, packages, and software. The whole system is (surprise, surprise) usually called a network or graph. The elements are commonly referred to as nodes (system theory jargon) or vertices (graph theory jargon) of a graph, while the connections are edges or links. I will mostly refer to the elements as nodes, and their connections as edges.

Generally, networks are a form of representing relational data. This is a very general tool that can be applied to many different types of relationships between all kind of elements. The content, meaning, and interpretation for sure depends on what elements we display, and which types of relationships. For example:

  • In Social Network Analysis:
    • Nodes represent actors (which can be persons, firms and other socially constructed entities)
    • Edges represent relationships between this actors (friendship, interaction, co-affiliation, similarity ect.)
  • Other types of network
    • Chemistry: Interaction between molecules
    • Computer Science: The wirld-wide-web, inter- and intranet topologies
    • Biology: Food-web, ant-hives

The possibilities to depict relational data are manifold. For example:

  • Relations among persons
    • Kinship: mother of, wife of…
    • Other role based: boss of, supervisor of…
    • Cognitive/perceptual: knows, aware of what they know…
    • Affective: likes, trusts…
    • Interaction: give advice, talks to…
    • Affiliation: belong to same clubs, shares same interests…
  • Relations among organizations
    • As corporate entities
    • Buy from / sell to, leases to, outsources to
    • Owns shares of, subsidiary of
    • Joint ventures, strategic alliances
    • Via their members
      • Personnel flows
      • Interlocking directorates
      • Personal friendships
      • Co-memberships
  • Relations other (non-social) entities
    • Patents
      • Patents citing other patents
      • Co-occurrence of technological classes *Research fields
      • through citations
      • through people co-affiliated with fields *Sectors
      • input-output relations
      • Labor mobility *Technologies
      • Patent IPC classes
      • Semantic co-occurrence

Note: Content matters! Each relation yields a different structure & has different effects. Theories might make sense on inter-personal, but not inter-organizational or non-social context.

The Data-Structure of Relational Data

Edgelist

MOst real world relational data is to be found in what we call an edge list, a dataframe that contains a minimum of two columns, one column of nodes that are the source of a connection and another column of nodes that are the target of the connection. The nodes in the data are identified by unique IDs. If the distinction between source and target is meaningful, the network is directed. If the distinction is not meaningful, the network is undirected (more on that later). So, every row that contains the ID of one element in column 1, and the ID of another element in column 2 indicates that a connection between them exists. An edge list can also contain additional columns that describe attributes of the edges such as a magnitude aspect for an edge. If the edges have a magnitude attribute the graph is considered weighted (more on that later). Below an example ofa minimal edge list created with the tibble() function.

edge_list <- tibble(from = c(1, 2, 2, 3, 4), to = c(2, 3, 4, 2, 1))
edge_list

Sometimes it is preferable to also create a separate node list. At its simplest, a node list is a data frame with a single column - which I will label as “id” - that lists the node IDs found in the edge list. The advantage of creating a separate node list is the ability to add attribute columns to the data frame such as the names of the nodes or any kind of groupings.

library(tidyverse)
node_list <- tibble(id = 1:4, group = sample(letters[1:2], 4, replace = TRUE))
node_list

Adjacency Matrix

A second popular form of network representation is the adjacency-matrix (also called socio-matrix). It is represented as a \(n*n\) matrix, where \(n\) stands for the number of elements of which their relationships should be represented. The value in the cell that intercepts row \(n\) and column \(m\) indicates if an edge is present (=1) or absent (=0).

Tip: Given an edgelist, an adjacency matrix can easily be produced by crosstabulating:

adj_matrix <- table(edge_list) %>% as.matrix()
adj_matrix
    to
from 1 2 3 4
   1 0 1 0 0
   2 0 0 1 1
   3 0 1 0 0
   4 1 0 0 0

Generating a Graph Object in igraph

To create an igraph object from an edge-list data frame we can use the graph_from_data_frame() function, which is a bit more straight forward than network(). There are three arguments in the graph_from_data_frame() function: d, vertices, and directed. Here, d refers to the edge list, vertices to the node list, and directed can be either TRUE or FALSE depending on whether the data is directed or undirected. By default, graph.data.frame() treats the first two columns of the edge list and any remaining columns as edge attributes.

library(igraph)
g <- graph_from_data_frame(d = edge_list, vertices = node_list, directed = FALSE)
g
IGRAPH d85cc1e UN-- 4 5 -- 
+ attr: name (v/c), group (v/c)
+ edges from d85cc1e (vertex names):
[1] 1--2 2--3 2--4 2--3 1--4

Lets inspect the resulting object. An igraph graph object summary reveals some interesting informations.

  • First, it tells us the graph-type: undirected UN, or directed DN
  • Afterwards, the number of nodes (4), and edges (6)
  • Followed by the node attributes (node level variables), which in this case are only their name (attr: name (v/c))
  • Lastly, a list of all existing edges. Note: n--m indicates an undirected, n->m an directed edge.

Lets take a look at the structure of the object:

glimpse(g[[1]])
List of 1
 $ 1: 'igraph.vs' Named int [1:2] 2 4
  ..- attr(*, "names")= chr [1:2] "2" "4"
  ..- attr(*, "env")=<weakref> 
  ..- attr(*, "graph")= chr "d85cc1e0-c674-11e8-816a-b7a131578cf9"

We see, the object has a list-format, consisting of sepperate lists for every node, containing some attributes which are irrelevant now, and an edgelist for every node, capturing its ego-network (eg., .. ..- attr(*, "names")= chr [1:2] "2" "4")

We can also plot it to take a look. igraph object can be directly used with the plot() function. The results can be adjusted with a set of parameters we will discover later. It’s not super pretty, therefore we will later also explore more powerfull plotting tools for rgaphs. However, its quick&dirty, so lets take it like that for now.

plot(g)

Yeah, that’s the graph. We We can also use the adjacency matrix to create the same graph.

g <- graph_from_adjacency_matrix(adj_matrix, mode = "undirected")
g
IGRAPH fcf6ff5 UN-- 4 4 -- 
+ attr: name (v/c)
+ edges from fcf6ff5 (vertex names):
[1] 1--2 1--4 2--3 2--4

We can inspect and manipulate the nodes via V(g) (V for vertices, its graph-theory slang), and edges with E(g)

V(g)
+ 4/4 vertices, named, from fcf6ff5:
[1] 1 2 3 4
E(g)
+ 4/4 edges from fcf6ff5 (vertex names):
[1] 1--2 1--4 2--3 2--4

We can also use most of the base-R slicing&dicing.

V(g)[1:3]
+ 3/4 vertices, named, from fcf6ff5:
[1] 1 2 3
E(g)[2:4]
+ 3/4 edges from fcf6ff5 (vertex names):
[1] 1--4 2--3 2--4

Remember, it’s a list-object. So, if we just want to have the values, we have to use the double bracket [[x]].

V(g)[[1:3]]
+ 3/4 vertices, named, from fcf6ff5:

We can also use the $ notation.

V(g)$name
[1] "1" "2" "3" "4"

Networks are coming…

Build the graph

rm(list=ls())
files <- list.files(path ="../data/GoT/", full.names = TRUE)
files
 [1] "../data/GoT/asoiaf-all-edges.csv"    "../data/GoT/asoiaf-all-nodes.csv"   
 [3] "../data/GoT/asoiaf-book1-edges.csv"  "../data/GoT/asoiaf-book1-nodes.csv" 
 [5] "../data/GoT/asoiaf-book2-edges.csv"  "../data/GoT/asoiaf-book2-nodes.csv" 
 [7] "../data/GoT/asoiaf-book3-edges.csv"  "../data/GoT/asoiaf-book3-nodes.csv" 
 [9] "../data/GoT/asoiaf-book4-edges.csv"  "../data/GoT/asoiaf-book4-nodes.csv" 
[11] "../data/GoT/asoiaf-book45-edges.csv" "../data/GoT/asoiaf-book45-nodes.csv"
[13] "../data/GoT/asoiaf-book5-edges.csv"  "../data/GoT/asoiaf-book5-nodes.csv" 
[15] "../data/GoT/union_characters.RDS"    "../data/GoT/union_edges.RDS"        
edges.cooc.all <- fread(files[1], data.table = FALSE) 
head(edges.cooc.all)

So, that’s what we have, a classical edgelist, with id1 in column 1 and id2 in column2. Note, the edges are in this case weighted.I don’t like the sepperating “-” between in the names, lets get rid of them.

colnames(edges.cooc.all) <- tolower(colnames(edges.cooc.all))
edges.cooc.all %<>%
  mutate(source = gsub("-", " ", source),
         target = gsub("-", " ", target)) 

Ok, lets see how many characters we have overal.

edges.cooc.all %>%
  select(-type) %>%
  gather(x, name, source:target) %>% 
  n_distinct(.$name)
[1] 5646
chars.main <- edges.cooc.all %>%
  select(-type) %>%
  gather(x, name, source:target) %>%
  group_by(name) %>%
  summarise(sum_weight = sum(weight)) %>%
  ungroup() %>%
  arrange(desc(sum_weight)) %>%
  top_n(50)
head(chars.main)

So far so good, if we only go by edge weights, Tyrion is going to make it…. my favorite anyhow…

However, lets reduce our edgelist to this main characters, just to warm up and keep the overview.

edges.cooc <- edges.cooc.all %>%
  filter(source %in% chars.main$name & target %in% chars.main$name) %>%
  select(source, target, weight)
g <- graph_from_data_frame(d = edges.cooc, directed = FALSE)
g
IGRAPH 10c1de6 UNW- 50 402 -- 
+ attr: name (v/c), weight (e/n)
+ edges from 10c1de6 (vertex names):
 [1] Aemon Targaryen (Maester Aemon)--Grenn             Aemon Targaryen (Maester Aemon)--Jeor Mormont     
 [3] Aemon Targaryen (Maester Aemon)--Jon Snow          Aemon Targaryen (Maester Aemon)--Mance Rayder     
 [5] Aemon Targaryen (Maester Aemon)--Robert Baratheon  Aemon Targaryen (Maester Aemon)--Samwell Tarly    
 [7] Aemon Targaryen (Maester Aemon)--Stannis Baratheon Arya Stark                     --Bran Stark       
 [9] Arya Stark                     --Catelyn Stark     Arya Stark                     --Cersei Lannister 
[11] Arya Stark                     --Eddard Stark      Arya Stark                     --Gregor Clegane   
[13] Arya Stark                     --Ilyn Payne        Arya Stark                     --Jaime Lannister  
[15] Arya Stark                     --Joffrey Baratheon Arya Stark                     --Jon Snow         
+ ... omitted several edges

Note that this co-occurence network is weighted (number of co-occurence), and undirected

is_weighted(g)
[1] TRUE
is_directed(g)
[1] FALSE

Inspect the graph

Overal graph attributes

We already know from the summary, but we can also count the number of nodes and edges as follows:

# Count number of edges
gsize(g)
[1] 402
# Count number of vertices
gorder(g)
[1] 50

We can give the graph a first plot to see what happens there. It’s not pretty, but we will fine-tune it later

plot(g)

We already see that some nodes are not connected (isolated), so lets drop them for our network analysis.

g <- delete_edges(g, E(g)[weight < 20])
g <- delete_vertices(g, degree(g) == 0)

Edges

# Find all edges that include "Britt"
E(g)[[inc('Daenerys Targaryen')]]  
+ 6/189 edges from 17b0991 (vertex names):
# Find all pairs that spend 4 or more hours together per week
E(g)[[weight >= 150]]
+ 11/189 edges from 17b0991 (vertex names):
hist(E(g)$weight)

Nodes

lets see who is the most central figure in this network of interactions

Degree centrality

degree(g) 
Aemon Targaryen (Maester Aemon)                      Arya Stark                 Barristan Selmy 
                              3                               9                               5 
                     Bran Stark                Brienne of Tarth                           Bronn 
                             14                               4                               2 
                  Catelyn Stark                Cersei Lannister              Daenerys Targaryen 
                             16                              20                               6 
                 Davos Seaworth                           Drogo                    Eddard Stark 
                              2                               2                              18 
                   Edmure Tully                  Gregor Clegane                           Grenn 
                              3                               4                               2 
               Hizdahr zo Loraq                           Hodor                      Ilyn Payne 
                              2                               4                               4 
                Jaime Lannister                    Jeor Mormont               Joffrey Baratheon 
                             16                               4                              19 
                     Jojen Reed                        Jon Snow                   Jorah Mormont 
                              3                              13                               3 
                   Loras Tyrell                           Luwin                      Lysa Arryn 
                              6                               6                               4 
                   Mance Rayder                 Margaery Tyrell                      Meera Reed 
                              1                               5                               3 
                     Melisandre                     Meryn Trant              Myrcella Baratheon 
                              3                               3                               3 
                  Petyr Baelish                         Pycelle                 Renly Baratheon 
                             10                               6                              10 
                   Rickon Stark                      Robb Stark                Robert Baratheon 
                              6                              17                              16 
                  Rodrik Cassel                   Samwell Tarly                  Sandor Clegane 
                              5                               5                               6 
                    Sansa Stark               Stannis Baratheon                   Theon Greyjoy 
                             17                              13                               6 
               Tommen Baratheon                Tyrion Lannister                 Tywin Lannister 
                              6                              25                               9 
                Quentyn Martell                           Varys 
                              2                               7 
which.max(degree(g))
Tyrion Lannister 
              47 
strength(g)
Aemon Targaryen (Maester Aemon)                      Arya Stark                 Barristan Selmy 
                            234                             512                             226 
                     Bran Stark                Brienne of Tarth                           Bronn 
                           1206                             225                             160 
                  Catelyn Stark                Cersei Lannister              Daenerys Targaryen 
                            766                            1438                             547 
                 Davos Seaworth                           Drogo                    Eddard Stark 
                            195                             151                            1175 
                   Edmure Tully                  Gregor Clegane                           Grenn 
                            128                             102                             121 
               Hizdahr zo Loraq                           Hodor                      Ilyn Payne 
                            138                             333                             112 
                Jaime Lannister                    Jeor Mormont               Joffrey Baratheon 
                            862                             277                            1343 
                     Jojen Reed                        Jon Snow                   Jorah Mormont 
                            223                            1238                             216 
                   Loras Tyrell                           Luwin                      Lysa Arryn 
                            167                             238                             179 
                   Mance Rayder                 Margaery Tyrell                      Meera Reed 
                            112                             258                             255 
                     Melisandre                     Meryn Trant              Myrcella Baratheon 
                            208                             102                              87 
                  Petyr Baelish                         Pycelle                 Renly Baratheon 
                            477                             193                             448 
                   Rickon Stark                      Robb Stark                Robert Baratheon 
                            263                             966                            1091 
                  Rodrik Cassel                   Samwell Tarly                  Sandor Clegane 
                            137                             472                             259 
                    Sansa Stark               Stannis Baratheon                   Theon Greyjoy 
                           1059                             771                             239 
               Tommen Baratheon                Tyrion Lannister                 Tywin Lannister 
                            337                            1694                             392 
                Quentyn Martell                           Varys 
                             80                             400 
which.max(strength(g))
Tyrion Lannister 
              47 

Neighborhood of a Node

neighbors(g, 'Robert Baratheon')
+ 16/50 vertices, named, from 17b0991:
 [1] Barristan Selmy    Catelyn Stark      Cersei Lannister   Daenerys Targaryen Eddard Stark      
 [6] Jaime Lannister    Joffrey Baratheon  Jon Snow           Petyr Baelish      Pycelle           
[11] Renly Baratheon    Sansa Stark        Stannis Baratheon  Tyrion Lannister   Tywin Lannister   
[16] Varys             

ego network

ego(g, 2, "Drogo")[[1]]
+ 8/50 vertices, named, from 17b0991:
[1] Drogo              Daenerys Targaryen Jorah Mormont      Barristan Selmy    Hizdahr zo Loraq   Robert Baratheon  
[7] Quentyn Martell    Tyrion Lannister  
g.drogo <- make_ego_graph(g, 2, nodes = "Drogo")[[1]]
g.danny <- make_ego_graph(g, 2, nodes = "Daenerys Targaryen")[[1]]
plot(g.drogo)

plot(g.danny)

Btw: To merge two graphs, just do:

g.merge
IGRAPH 45a00e4 UN-- 21 82 -- 
+ attr: name (v/c), weight_1 (e/n), weight_2 (e/n)
+ edges from 45a00e4 (vertex names):
 [1] Stannis Baratheon--Tywin Lannister   Renly Baratheon  --Stannis Baratheon Pycelle          --Varys            
 [4] Petyr Baelish    --Varys             Petyr Baelish    --Sansa Stark       Petyr Baelish    --Pycelle          
 [7] Jon Snow         --Stannis Baratheon Joffrey Baratheon--Varys             Joffrey Baratheon--Tywin Lannister  
[10] Joffrey Baratheon--Stannis Baratheon Joffrey Baratheon--Sansa Stark       Joffrey Baratheon--Renly Baratheon  
[13] Joffrey Baratheon--Petyr Baelish     Jaime Lannister  --Tywin Lannister   Jaime Lannister  --Sansa Stark      
[16] Jaime Lannister  --Renly Baratheon   Jaime Lannister  --Joffrey Baratheon Eddard Stark     --Varys            
[19] Eddard Stark     --Stannis Baratheon Eddard Stark     --Sansa Stark       Eddard Stark     --Renly Baratheon  
[22] Eddard Stark     --Pycelle           Eddard Stark     --Petyr Baelish     Eddard Stark     --Jon Snow         
+ ... omitted several edges

Betweenness Centrality

betweenness(g)
Aemon Targaryen (Maester Aemon)                      Arya Stark                 Barristan Selmy 
                            0.0                            19.0                            93.0 
                     Bran Stark                Brienne of Tarth                           Bronn 
                           17.5                             0.0                             0.0 
                  Catelyn Stark                Cersei Lannister              Daenerys Targaryen 
                           94.0                            96.5                             0.0 
                 Davos Seaworth                           Drogo                    Eddard Stark 
                            0.0                             0.0                           138.0 
                   Edmure Tully                  Gregor Clegane                           Grenn 
                            0.0                            15.0                             0.0 
               Hizdahr zo Loraq                           Hodor                      Ilyn Payne 
                            0.0                            85.0                             8.5 
                Jaime Lannister                    Jeor Mormont               Joffrey Baratheon 
                           67.5                            57.0                            63.0 
                     Jojen Reed                        Jon Snow                   Jorah Mormont 
                            0.0                           116.0                            47.5 
                   Loras Tyrell                           Luwin                      Lysa Arryn 
                           57.5                           133.0                             0.0 
                   Mance Rayder                 Margaery Tyrell                      Meera Reed 
                            0.0                             0.0                             0.0 
                     Melisandre                     Meryn Trant              Myrcella Baratheon 
                           19.0                             0.0                             1.0 
                  Petyr Baelish                         Pycelle                 Renly Baratheon 
                            7.0                            25.0                            31.0 
                   Rickon Stark                      Robb Stark                Robert Baratheon 
                           73.0                            98.5                           155.5 
                  Rodrik Cassel                   Samwell Tarly                  Sandor Clegane 
                           25.0                            20.0                            13.0 
                    Sansa Stark               Stannis Baratheon                   Theon Greyjoy 
                          137.0                           103.0                            30.0 
               Tommen Baratheon                Tyrion Lannister                 Tywin Lannister 
                            0.0                           309.0                            24.0 
                Quentyn Martell                           Varys 
                            0.0                             0.0 

Eigenvector Centrality

eigen_centrality(g, scale = TRUE)$vector %>% round(3)
Aemon Targaryen (Maester Aemon)                      Arya Stark                 Barristan Selmy 
                          0.064                           0.332                           0.073 
                     Bran Stark                Brienne of Tarth                           Bronn 
                          0.297                           0.126                           0.183 
                  Catelyn Stark                Cersei Lannister              Daenerys Targaryen 
                          0.415                           0.952                           0.039 
                 Davos Seaworth                           Drogo                    Eddard Stark 
                          0.060                           0.007                           0.754 
                   Edmure Tully                  Gregor Clegane                           Grenn 
                          0.067                           0.072                           0.035 
               Hizdahr zo Loraq                           Hodor                      Ilyn Payne 
                          0.008                           0.079                           0.086 
                Jaime Lannister                    Jeor Mormont               Joffrey Baratheon 
                          0.547                           0.113                           0.922 
                     Jojen Reed                        Jon Snow                   Jorah Mormont 
                          0.046                           0.364                           0.038 
                   Loras Tyrell                           Luwin                      Lysa Arryn 
                          0.112                           0.061                           0.121 
                   Mance Rayder                 Margaery Tyrell                      Meera Reed 
                          0.047                           0.200                           0.051 
                     Melisandre                     Meryn Trant              Myrcella Baratheon 
                          0.065                           0.089                           0.067 
                  Petyr Baelish                         Pycelle                 Renly Baratheon 
                          0.353                           0.156                           0.267 
                   Rickon Stark                      Robb Stark                Robert Baratheon 
                          0.098                           0.428                           0.755 
                  Rodrik Cassel                   Samwell Tarly                  Sandor Clegane 
                          0.044                           0.127                           0.186 
                    Sansa Stark               Stannis Baratheon                   Theon Greyjoy 
                          0.723                           0.367                           0.091 
               Tommen Baratheon                Tyrion Lannister                 Tywin Lannister 
                          0.270                           1.000                           0.333 
                Quentyn Martell                           Varys 
                          0.004                           0.345 

graph structure

edge_density(g)
[1] 0.1542857
diameter(g, directed = F, weights = NA)
[1] 4
transitivity(g)
[1] 0.4552807
mean_distance(g, directed = F)
[1] 2.337959

Your turn

Ahh, you saw it comming, right? What about you explore the GoT network a bit on your own HERE. Lets see how that works out!

Directed Networks are comming…

So far so good, up to now we considered undirected networks, constructed by the amount characters co-occur. However, as you already might guess, that’s not where we stop.

There are also other relationships to which we can, and sometimes have to, assign a directionality. An obvious example here are family ties. Here, I will ose the nicely compiled dataset of the wonderful Shirin that can be found here. It contains a nodelist with house-affiliations and furtehr characteristics of main characters, and a edgelist of their family relationships.

rm(chars.main, g, g.danny, g.drogo, g.merge)
edges.fam <- readRDS("../data/GoT/union_edges.RDS")
nodes.fam <- readRDS("../data/GoT/union_characters.RDS")
head(nodes.fam)
head(edges.fam)
g <- graph_from_data_frame(edges.fam, 
                           vertices = nodes.fam,
                           directed = TRUE)
g
IGRAPH 813c92b DN-- 208 404 -- 
+ attr: name (v/c), male (v/n), culture (v/c), house (v/c), popularity (v/n), house2 (v/c), color (v/c),
| shape (v/c), type (e/c), color (e/c), lty (e/c)
+ edges from 813c92b (vertex names):
 [1] Lysa Arryn       ->Robert Arryn       Jasper Arryn     ->Alys Arryn        
 [3] Jasper Arryn     ->Jon Arryn          Jon Arryn        ->Robert Arryn      
 [5] Cersei Lannister ->Tommen Baratheon   Cersei Lannister ->Joffrey Baratheon 
 [7] Cassana Baratheon->Stannis Baratheon  Cersei Lannister ->Myrcella Baratheon
 [9] Selyse Florent   ->Shireen Baratheon  Cassana Baratheon->Renly Baratheon   
[11] Rhaelle Targaryen->Steffon Baratheon  Cassana Baratheon->Robert Baratheon  
[13] Robert Baratheon ->Tommen Baratheon   Robert Baratheon ->Joffrey Baratheon 
+ ... omitted several edges
plot(g)

For plotting the legend, I am summarizing the edge and node colors.

color_vertices <- nodes.fam %>%
  group_by(house, color) %>%
  summarise(n = n()) %>%
  filter(!is.na(color))
colors_edges <- edges.fam %>%
  group_by(type, color) %>%
  summarise(n = n()) %>%
  filter(!is.na(color))
plot(g,
     layout = layout_with_fr(g),
     vertex.label = gsub(" ", "\n", V(g)$name),
     vertex.shape = V(g)$shape,
     vertex.color = V(g)$color, 
     vertex.size = (V(g)$popularity + 0.5) * 5, 
     vertex.frame.color = "gray", 
     vertex.label.color = "black", 
     vertex.label.cex = 0.8,
     edge.arrow.size = 0.5,
     edge.color = E(g)$color,
     edge.lty = E(g)$lty)
legend("topleft", legend = c(NA, "Node color:", as.character(color_vertices$house), NA, "Edge color:", as.character(colors_edges$type)), pch = 10,
       col = c(NA, NA, color_vertices$color, NA, NA, colors_edges$color), pt.cex = 3, cex = 2, bty = "n", ncol = 1,
       title = "") 
legend("topleft", legend = "", cex = 3, bty = "n", ncol = 1,
       title = "Game of Thrones Family Ties")

Community Detection

You might have already guessed, we can very well also do a clustering exercise in networks. Here, we do not cluster nodes according to their similarity in attributes, but according to their connectivity. There are plenty of algorithms,, and we will explore further ones lateron. Most of them aim to find communities with maximum within/connectivity, and minimum between/connectivity.

However, most of them are not designed to work with directed networks. Therefore, we will convert our nice network for now to an undirected one.

g.ud <- as.undirected(g)

First, we will give it a try with the edge-betweenness algorithm (Newman-Girvan). Here, high-betweenness edges are removed sequentially (recalculating at each step) and the best partitioning of the network is selected.

Lets take a look how it works.

And we now run it. As an hirarchical community detection technique. Since it is an hirarchical one, we can again plot a dendogram which we already know from the hirarchical clustering

ceb
IGRAPH clustering edge betweenness, groups: 12, mod: 0.84
+ groups:
  $`1`
   [1] "Alys Arryn"       "Elys Waynwood"    "Jasper Arryn"     "Jeyne Royce"      "Jon Arryn"       
   [6] "Lysa Arryn"       "Robert Arryn"     "Rowena Arryn"     "Edmure Tully"     "Sansa Stark"     
  [11] "Arya Stark"       "Bran Stark"       "Catelyn Stark"    "Eddard Stark"     "Jeyne Westerling"
  [16] "Rickon Stark"     "Robb Stark"       "Talisa Stark"     "Hoster Tully"     "Minisa Whent"    
  [21] "Petyr Baelish"   
  
  $`2`
   [1] "Cassana Baratheon"  "Cersei Lannister"   "Jaime Lannister"    "Joffrey Baratheon"  "Margaery Tyrell"   
   [6] "Myrcella Baratheon" "Renly Baratheon"    "Robert Baratheon"   "Selyse Florent"     "Shireen Baratheon" 
  + ... omitted several groups/vertices
plot(ceb, g.ud,
     vertex.frame.color = V(g)$color, # load the predefined color of the nodes (houses)
     vertex.size = (V(g)$popularity + 0.5) * 5 # define node-size by popularity) 
)

Lets only see how good it performs on the major houses, the rest is too small anyhow

bind_cols(com = ceb$membership, house = V(g.ud)$house) %>%
  group_by(house) %>%
  filter(n() >= 10) %>%
  ungroup() %>%
  table()
    house
com  House Baratheon House Frey House Greyjoy House Lannister House Martell House Stark House Targaryen House Tyrell
  1                0          0             0               0             0           7               0            0
  2                9          0             0               4             0           0               0            1
  3                1          0             0               0             2           0              13            0
  4                0         13             0               0             0           0               0            0
  5                0          7             0               9             0           0               0            0
  6                0          0            14               0             0           0               0            0
  7                0          0             0              13             0           0               0            0
  8                0          0             0               0            11           0               0            0
  9                0          0             0               0             0           6               0            0
  10               0          0             0               0             0          13               0            0
  11               0          0             0               0             0           0               0            9
  12               0          0             0               0             0           0               0            5

We see, indeed, that the communities for the most part capture the affiliation to the great houses.

Your turn

AGain, its time to have some fun on your own. HERE you will find another kaggle notebook where you can demonstrate your network analysis skills even more!

LS0tDQp0aXRsZTogJ00yLTEtMjogSW50cm9kdWN0aW9uIHRvIE5ldHdvcmsgQW5hbHlzaXMnDQphdXRob3I6ICJEYW5pZWwgUy4gSGFpbiAoZHNoQGJ1c2luZXNzLmFhdS5kaykiDQpkYXRlOiAiMDMvMTAvMjAxOCINCm91dHB1dDoNCiAgaHRtbF9kb2N1bWVudDoNCiAgICBkZl9wcmludDogcGFnZWQNCiAgICB0b2M6IHllcw0KICAgIHRvY19mbG9hdDogdHJ1ZQ0KICBodG1sX25vdGVib29rOg0KICAgIGRmX3ByaW50OiBwYWdlZA0KICAgIG51bWJlcl9zZWN0aW9uczogbm8NCiAgICB0b2M6IHllcw0KLS0tDQoNCmBgYHtyIHNldHVwLCBpbmNsdWRlPUZBTFNFfQ0KIyMjIEdlbmVyaWMgcHJlYW1ibGUNClN5cy5zZXRlbnYoTEFORyA9ICJlbiIpDQoNCiMjIyBDbGVhbiBXb3Jrc3BhY2UgKEkgbGlrZSB0byBzdGFydCBjbGVhbikNCnJtKGxpc3Q9bHMoKSk7IGdyYXBoaWNzLm9mZigpICMgZ2V0IHJpZCBvZiBldmVyeXRoaW5nIGluIHRoZSB3b3Jrc3BhY2UNCmRldGFjaEFsbFBhY2thZ2VzIDwtIGZ1bmN0aW9uKCkgeyAjIEFsc28sIGRldGFjaCBwYWNrYWdlcyB0byBhdm9pZCBmdW5jdGlvbnMgbWFza2VkIGJ5IG90aGVycw0KICBiYXNpYy5wYWNrYWdlcyA8LSBjKCJwYWNrYWdlOnN0YXRzIiwicGFja2FnZTpncmFwaGljcyIsInBhY2thZ2U6Z3JEZXZpY2VzIiwicGFja2FnZTp1dGlscyIsInBhY2thZ2U6ZGF0YXNldHMiLCJwYWNrYWdlOm1ldGhvZHMiLCJwYWNrYWdlOmJhc2UiKQ0KICBwYWNrYWdlLmxpc3QgPC0gc2VhcmNoKClbaWZlbHNlKHVubGlzdChncmVnZXhwcigicGFja2FnZToiLHNlYXJjaCgpKSk9PTEsVFJVRSxGQUxTRSldDQogIHBhY2thZ2UubGlzdCA8LSBzZXRkaWZmKHBhY2thZ2UubGlzdCxiYXNpYy5wYWNrYWdlcykNCiAgaWYgKGxlbmd0aChwYWNrYWdlLmxpc3QpPjApICBmb3IgKHBhY2thZ2UgaW4gcGFja2FnZS5saXN0KSBkZXRhY2gocGFja2FnZSwgY2hhcmFjdGVyLm9ubHk9VFJVRSkNCn0NCmRldGFjaEFsbFBhY2thZ2VzKCk7IHJtKGRldGFjaEFsbFBhY2thZ2VzKQ0KDQojIyMgY2hlY2tpbmcgaWYgYWxsIHdlIG5lZWQgaXMgaW5zdGFsbGVkDQpsaXN0Lm9mLnBhY2thZ2VzIDwtIGMoImtuaXRyIiwgInRpZHl2ZXJzZSIsICJtYWdyaXR0ciIsICJkYXRhLnRhYmxlIiwgInNraW1yIikNCg0KbmV3LnBhY2thZ2VzIDwtIGxpc3Qub2YucGFja2FnZXNbIShsaXN0Lm9mLnBhY2thZ2VzICVpbiUgaW5zdGFsbGVkLnBhY2thZ2VzKClbLCJQYWNrYWdlIl0pXQ0KaWYobGVuZ3RoKG5ldy5wYWNrYWdlcykpIGluc3RhbGwucGFja2FnZXMobmV3LnBhY2thZ2VzKQ0Kcm0obGlzdC5vZi5wYWNrYWdlcywgbmV3LnBhY2thZ2VzKQ0KDQojIyMgTG9hZCBwYWNrYWdlcyAgU3RhbmRhcmQNCmxpYnJhcnkoa25pdHIpICMgRm9yIGRpc3BsYXkgb2YgdGhlIG1hcmtkb3duDQpsaWJyYXJ5KHRpZHl2ZXJzZSkgIyBDb2xsZWN0aW9uIG9mIGFsbCB0aGUgZ29vZCBzdHVmZiBsaWtlIGRwbHlyLCBnZ3Bsb3QyIGVjdC4NCmxpYnJhcnkobWFncml0dHIpICMgRm9yIGV4dHJhLXBpcGluZyBvcGVyYXRvcnMgKGVnLiAlPD4lKQ0KbGlicmFyeShkYXRhLnRhYmxlKSAjIEdvb2QgZm9ybWF0IHRvIHdvcmsgd2l0aCBsYXJnZSBkYXRhc2V0cw0KbGlicmFyeShza2ltcikgIyBOaWNlIGRlc2NyaXB0aXZlcw0KDQoNCiMjIyBLbml0ciBvcHRpb25zDQpvcHRzX2NodW5rJHNldCh3YXJuaW5nID0gRkFMU0UsDQogICAgICAgICAgICAgICBtZXNzYWdlID0gRkFMU0UsDQogICAgICAgICAgICAgICBmaWcuYWxpZ24gID0gImNlbnRlciINCiAgICAgICAgICAgICAgICkNCmBgYA0KDQpTb21lIGhvdXNla2VlcGluZyAoYWdhaW4pLCBpbnN0YWxsaW5nIG5lY2Vzc2FyeSBwYWNrYWdlcy4NCg0KYGBge3J9DQpsaXN0Lm9mLnBhY2thZ2VzIDwtIGMoImlncmFwaCIsICJ0aWR5Z3JhcGgiLCAiZ2dyYXBoIikNCg0KbmV3LnBhY2thZ2VzIDwtIGxpc3Qub2YucGFja2FnZXNbIShsaXN0Lm9mLnBhY2thZ2VzICVpbiUgaW5zdGFsbGVkLnBhY2thZ2VzKClbLCJQYWNrYWdlIl0pXQ0KaWYobGVuZ3RoKG5ldy5wYWNrYWdlcykpIGluc3RhbGwucGFja2FnZXMobmV3LnBhY2thZ2VzKQ0Kcm0obGlzdC5vZi5wYWNrYWdlcywgbmV3LnBhY2thZ2VzKQ0KYGBgDQoNCg0KIyBJbnRyb2R1Y3Rpb24NCg0KIyMgTmV0d29ya3MuLi4gU28gd2hhdD8NClNvLCBiZWZvcmUgd2UgdGFsayBhYm91dCBuZXR3b3Jrcywgb25lIHRoaW5nIHVwZnJvbnQuLi4gd2h5IHNob3VsZCB3ZT8gSSBtZWFuLCB0aGV5IHVuZGVuaWFibHkgbG9vayBwcmV0dHksIGRvbid0IHRoZXk/DQoNCiFbXSguLi9tZWRpYS9NMl8xX25ldHdvcmsucG5nKXt3aWR0aD03NTBweH0NCg0KU29tZWhvdywgdGhlIHZpc3VhbGl6YXRpb24gb2YgbmV0d29ya3MgZmFzY2luYXRlcyB0aGUgaHVtYW4gbWluZCAoZmluZCBhIHNob3J0IFRFRCB0YWxrIG9uIG5ldHdvcmtzIGFuZCBob3cgdGhleSBkZXBpY3Qgb3VyIHdvcmxkIFtoZXJlXShodHRwczovL3d3dy50ZWQuY29tL3RhbGtzL21hbnVlbF9saW1hX2FfdmlzdWFsX2hpc3Rvcnlfb2ZfaHVtYW5fa25vd2xlZGdlKSksIGFuZCBoYXMgZXZlbiBpbnNwaXJlZCBhbiBvd24gYXJ0IG1vdmVtZW50LCBuZXR3b3JraXNtIChzZWUgc29tZSBleGFtcGxlcyBbaGVyZV0oaHR0cHM6Ly93d3cuYmVoYW5jZS5uZXQvZ2FsbGVyeS8xODQwNDUvTGlua3MpKS4gDQoNCllldCwgYmVzaWRlcyB0aGF0LCBpcyB0aGVyZSBhbiBhbmFseXRpY2FsIHZhbHVlIGZvciBhIGRhdGEgc2NpZW50aXN0IHRvIGJvdGhlciBhYm91dCBuZXR3b3Jrcz8NCg0KIVtdKC4uL21lZGlhL00yXzFfZ29vZ2xlX2FwcGxlLnBuZyl7d2lkdGg9NzUwcHh9DQoNCg0KIyMgTmV0d29ya3MgaW4gUg0KVGhlcmUgYXJlIGEgbnVtYmVyIG9mIGFwcGxpY2F0aW9ucyBkZXNpZ25lZCBmb3IgbmV0d29yayBhbmFseXNpcyBhbmQgdGhlIGNyZWF0aW9uIG9mIG5ldHdvcmsgZ3JhcGhzIHN1Y2ggYXMgW2dlcGhpXShodHRwczovL2dlcGhpLm9yZykgYW5kIFtjeXRvc2NhcGVdKGh0dHA6Ly9jeXRvc2NhcGUub3JnKS4gVGhvdWdoIG5vdCBzcGVjaWZpY2FsbHkgZGVzaWduZWQgZm9yIGl0LCBSIGhhcyBkZXZlbG9wZWQgaW50byBhIHBvd2VyZnVsIHRvb2wgZm9yIG5ldHdvcmsgYW5hbHlzaXMuIA0KDQpTaWduaWZpY2FudCBuZXR3b3JrIGFuYWx5c2lzIHBhY2thZ2VzIGZvciBSIGluY2x1ZGUgdGhlIFtgbmV0d29ya2BdKGh0dHBzOi8vY3Jhbi5yLXByb2plY3Qub3JnL3dlYi9wYWNrYWdlcy9uZXR3b3JrL2luZGV4Lmh0bWwpLCBbYHNuYWBdKGh0dHBzOi8vY3Jhbi5yLXByb2plY3Qub3JnL3dlYi9wYWNrYWdlcy9zbmEvaW5kZXguaHRtbCksIGFuZCBbYGlncmFwaGBdKGh0dHA6Ly9pZ3JhcGgub3JnKSBwYWNrYWdlLiBJbiBhZGRpdGlvbiwgW1Rob21hcyBMaW4gUGVkZXJzZW5dKGh0dHA6Ly93d3cuZGF0YS1pbWFnaW5pc3QuY29tKSBoYXMgcmVjZW50bHkgcmVsZWFzZWQgdGhlIFtgdGlkeWdyYXBoYF0oaHR0cHM6Ly9jcmFuLnItcHJvamVjdC5vcmcvd2ViL3BhY2thZ2VzL3RpZHlncmFwaC9pbmRleC5odG1sKSBwYWNrYWdlIHRoYXQgbGV2ZXJhZ2UgdGhlIHBvd2VyIG9mIGBpZ3JhcGhgIGluIGEgbWFubmVyIGNvbnNpc3RlbnQgd2l0aCB0aGUgW2B0aWR5dmVyc2VgXShodHRwOi8vd3d3LnRpZHl2ZXJzZS5vcmcpIHdvcmtmbG93LiBFdmVuIGJldHRlciwgaGUgdG9wcyBpdCB1cCB3aXRoIFtgZ2dyYXBoYF0oaHR0cHM6Ly9jcmFuLnItcHJvamVjdC5vcmcvd2ViL3BhY2thZ2VzL2dncmFwaC9pbmRleC5odG1sKSwgYSBjb25zaXN0ZW50ILRnZ3Bsb3QytC1sb29rLWFuZC1mZWVsIG5ldHdvcmsgdmlzdWFsaXphdGlvbiBwYWNrYWdlLg0KDQpSIGNhbiBhbHNvIGJlIHVzZWQgdG8gbWFrZSBpbnRlcmFjdGl2ZSBuZXR3b3JrIGdyYXBocyB3aXRoIHRoZSBbaHRtbHdpZGdldHMgZnJhbWV3b3JrXShodHRwOi8vd3d3Lmh0bWx3aWRnZXRzLm9yZykgdGhhdCB0cmFuc2xhdGVzIFIgY29kZSB0byBKYXZhU2NyaXB0LiBDb29sIGltcGxlbWVudGF0aW9ucyB0aGVyZW9mIGFyZSB0aGUgW2B2aXpOZXR3b3JrYF0oaHR0cDovL2RhdGFzdG9ybS1vcGVuLmdpdGh1Yi5pby92aXNOZXR3b3JrLykgYW5kIFtgbmV0d29ya0QzYF0oaHR0cDovL2NocmlzdG9waGVyZ2FuZHJ1ZC5naXRodWIuaW8vbmV0d29ya0QzLykgcGFja2FnZXMuDQoNCkFzIGFuYWx5dGljYWwgdG9vbCwgSSB3aWxsIGluIHRoaXMgbGFiIG1vc3RseSB1c2UgW2BpZ3JhcGhgXShodHRwOi8vaWdyYXBoLm9yZykuIEluIHRlcm1zIG9mIGZ1bmN0aW9ucywgaXQgaXMgcHJldHR5IG11Y2ggZXF1aXZhbGVudCB0byBbYG5ldHdvcmtgXShodHRwczovL2NyYW4uci1wcm9qZWN0Lm9yZy93ZWIvcGFja2FnZXMvbmV0d29yay9pbmRleC5odG1sKSwgeWV0IHNsaWdodGx5IG1vcmUgcG93ZXJmdWwsIGJldHRlciBpbnRlZ3JhdGVkLCBhbmQgbWFpbnRhaW5lZC4gU2luY2UgYm90aCBwYWNrYWdlcyBoYXZlIG1hbnkgb2YgdGhlIHNhbWUgZnVuY3Rpb25zLCBiZXR0ZXIgZG9uJ3QgbG9hZCB0aGVtIGJvdGggYXQgb25jZS4NCg0KDQojIyBUaGUgQmFzaWMgU3RydWN0dXJlIG9mIE5ldHdvcmtzDQoNCiMjIyBUaGUgQmFzaWMgSmFyZ29uDQpGaXJzdCBvZiBhbGwsIHdoYXQgaXMgYSBuZXR3b3JrPyBQbGFpbmx5IHNwZWFraW5nLCBhIG5ldHdvcmsgaXMgYSBzeXN0ZW0gb2YgZWxlbWVudHMgd2hpY2ggYXJlIGNvbm5lY3RlZCBieSBzb21lIHJlbGF0aW9uc2hpcC4gVGhlIHZvY2FidWxhcnkgY2FuIGJlIGEgYml0IHRlY2huaWNhbCBhbmQgZXZlbiBpbmNvbnNpc3RlbnQgYmV0d2VlbiBkaWZmZXJlbnQgZGlzY2lwbGluZXMsIHBhY2thZ2VzLCBhbmQgc29mdHdhcmUuIFRoZSB3aG9sZSBzeXN0ZW0gaXMgKHN1cnByaXNlLCBzdXJwcmlzZSkgdXN1YWxseSBjYWxsZWQgYSAqKm5ldHdvcmsqKiBvciAqKmdyYXBoKiouIFRoZSBlbGVtZW50cyBhcmUgY29tbW9ubHkgcmVmZXJyZWQgdG8gYXMgKipub2RlcyoqIChzeXN0ZW0gdGhlb3J5IGphcmdvbikgb3IgKip2ZXJ0aWNlcyoqIChncmFwaCB0aGVvcnkgamFyZ29uKSBvZiBhIGdyYXBoLCB3aGlsZSB0aGUgY29ubmVjdGlvbnMgYXJlICoqZWRnZXMqKiBvciAqKmxpbmtzKiouIEkgd2lsbCBtb3N0bHkgcmVmZXIgdG8gdGhlIGVsZW1lbnRzIGFzIG5vZGVzLCBhbmQgdGhlaXIgY29ubmVjdGlvbnMgYXMgZWRnZXMuDQoNCiFbXSguLi9tZWRpYS9NMl8xX253X2lsbHUucG5nKXt3aWR0aD01MDBweH0NCg0KR2VuZXJhbGx5LCBuZXR3b3JrcyBhcmUgYSBmb3JtIG9mIHJlcHJlc2VudGluZyAqKnJlbGF0aW9uYWwgZGF0YSoqLiBUaGlzIGlzIGEgdmVyeSBnZW5lcmFsIHRvb2wgdGhhdCBjYW4gYmUgYXBwbGllZCB0byBtYW55IGRpZmZlcmVudCB0eXBlcyBvZiByZWxhdGlvbnNoaXBzIGJldHdlZW4gYWxsIGtpbmQgb2YgZWxlbWVudHMuIFRoZSBjb250ZW50LCBtZWFuaW5nLCBhbmQgaW50ZXJwcmV0YXRpb24gZm9yIHN1cmUgZGVwZW5kcyBvbiB3aGF0IGVsZW1lbnRzIHdlIGRpc3BsYXksIGFuZCB3aGljaCB0eXBlcyBvZiByZWxhdGlvbnNoaXBzLiBGb3IgZXhhbXBsZToNCg0KDQoqIEluIFNvY2lhbCBOZXR3b3JrIEFuYWx5c2lzOg0KICAgICAqIE5vZGVzIHJlcHJlc2VudCBhY3RvcnMgKHdoaWNoIGNhbiBiZSBwZXJzb25zLCBmaXJtcyBhbmQgb3RoZXIgc29jaWFsbHkgY29uc3RydWN0ZWQgZW50aXRpZXMpDQogICAgICogRWRnZXMgcmVwcmVzZW50IHJlbGF0aW9uc2hpcHMgYmV0d2VlbiB0aGlzIGFjdG9ycyAoZnJpZW5kc2hpcCwgaW50ZXJhY3Rpb24sIGNvLWFmZmlsaWF0aW9uLCBzaW1pbGFyaXR5IGVjdC4pDQoqIE90aGVyIHR5cGVzIG9mIG5ldHdvcmsNCiAgICAgKiBDaGVtaXN0cnk6IEludGVyYWN0aW9uIGJldHdlZW4gbW9sZWN1bGVzDQogICAgICogQ29tcHV0ZXIgU2NpZW5jZTogVGhlIHdpcmxkLXdpZGUtd2ViLCBpbnRlci0gYW5kIGludHJhbmV0IHRvcG9sb2dpZXMNCiAgICAgKiBCaW9sb2d5OiBGb29kLXdlYiwgYW50LWhpdmVzDQoNClRoZSBwb3NzaWJpbGl0aWVzIHRvIGRlcGljdCByZWxhdGlvbmFsIGRhdGEgYXJlIG1hbmlmb2xkLiBGb3IgZXhhbXBsZToNCg0KKiBSZWxhdGlvbnMgYW1vbmcgcGVyc29ucw0KICAgICAqIEtpbnNoaXA6IG1vdGhlciBvZiwgd2lmZSBvZi4uLg0KICAgICAqIE90aGVyIHJvbGUgYmFzZWQ6IGJvc3Mgb2YsIHN1cGVydmlzb3Igb2YuLi4NCiAgICAgKiBDb2duaXRpdmUvcGVyY2VwdHVhbDoga25vd3MsIGF3YXJlIG9mIHdoYXQgdGhleSBrbm93Li4uDQogICAgICogQWZmZWN0aXZlOiBsaWtlcywgdHJ1c3RzLi4uDQogICAgICogSW50ZXJhY3Rpb246IGdpdmUgYWR2aWNlLCB0YWxrcyB0by4uLg0KICAgICAqIEFmZmlsaWF0aW9uOiBiZWxvbmcgdG8gc2FtZSBjbHVicywgc2hhcmVzIHNhbWUgaW50ZXJlc3RzLi4uDQoqIFJlbGF0aW9ucyBhbW9uZyBvcmdhbml6YXRpb25zDQogICAgICogQXMgY29ycG9yYXRlIGVudGl0aWVzDQogICAgICogQnV5IGZyb20gLyBzZWxsIHRvLCBsZWFzZXMgdG8sIG91dHNvdXJjZXMgdG8NCiAgICAgKiBPd25zIHNoYXJlcyBvZiwgc3Vic2lkaWFyeSBvZg0KICAgICAqIEpvaW50IHZlbnR1cmVzLCBzdHJhdGVnaWMgYWxsaWFuY2VzDQogICAgICogVmlhIHRoZWlyIG1lbWJlcnMNCiAgICAgICAgICAqIFBlcnNvbm5lbCBmbG93cw0KICAgICAgICAgICogSW50ZXJsb2NraW5nIGRpcmVjdG9yYXRlcw0KICAgICAgICAgICogUGVyc29uYWwgZnJpZW5kc2hpcHMNCiAgICAgICAgICAqIENvLW1lbWJlcnNoaXBzDQoqIFJlbGF0aW9ucyBvdGhlciAobm9uLXNvY2lhbCkgZW50aXRpZXMNCiAgICAgKiBQYXRlbnRzDQogICAgICAgICAgKiBQYXRlbnRzIGNpdGluZyBvdGhlciBwYXRlbnRzDQogICAgICAgICAgKiBDby1vY2N1cnJlbmNlIG9mIHRlY2hub2xvZ2ljYWwgY2xhc3Nlcw0KICAgICAqUmVzZWFyY2ggZmllbGRzDQogICAgICAgICAgKiB0aHJvdWdoIGNpdGF0aW9ucw0KICAgICAgICAgICogdGhyb3VnaCBwZW9wbGUgY28tYWZmaWxpYXRlZCB3aXRoIGZpZWxkcw0KICAgICAqU2VjdG9ycw0KICAgICAgICAgICogaW5wdXQtb3V0cHV0IHJlbGF0aW9ucw0KICAgICAgICAgICogTGFib3IgbW9iaWxpdHkNCiAgICAgKlRlY2hub2xvZ2llcw0KICAgICAgICAgICogUGF0ZW50IElQQyBjbGFzc2VzDQogICAgICAgICAgKiBTZW1hbnRpYyBjby1vY2N1cnJlbmNlIA0KDQoNCioqTm90ZTogQ29udGVudCBtYXR0ZXJzISoqIEVhY2ggcmVsYXRpb24geWllbGRzIGEgZGlmZmVyZW50IHN0cnVjdHVyZSAmIGhhcyBkaWZmZXJlbnQgZWZmZWN0cy4gVGhlb3JpZXMgbWlnaHQgbWFrZSBzZW5zZSBvbiBpbnRlci1wZXJzb25hbCwgYnV0IG5vdCBpbnRlci1vcmdhbml6YXRpb25hbCBvciBub24tc29jaWFsIGNvbnRleHQuDQoNCg0KIyMjIFRoZSBEYXRhLVN0cnVjdHVyZSBvZiBSZWxhdGlvbmFsIERhdGENCg0KIyMjIyBFZGdlbGlzdA0KTU9zdCByZWFsIHdvcmxkIHJlbGF0aW9uYWwgZGF0YSBpcyB0byBiZSBmb3VuZCBpbiB3aGF0IHdlIGNhbGwgYW4gKiplZGdlIGxpc3QqKiwgYSBkYXRhZnJhbWUgdGhhdCBjb250YWlucyBhIG1pbmltdW0gb2YgdHdvIGNvbHVtbnMsIG9uZSBjb2x1bW4gb2YgKm5vZGVzKiB0aGF0IGFyZSB0aGUgc291cmNlIG9mIGEgY29ubmVjdGlvbiBhbmQgYW5vdGhlciBjb2x1bW4gb2Ygbm9kZXMgdGhhdCBhcmUgdGhlIHRhcmdldCBvZiB0aGUgY29ubmVjdGlvbi4gVGhlIG5vZGVzIGluIHRoZSBkYXRhIGFyZSBpZGVudGlmaWVkIGJ5IHVuaXF1ZSBJRHMuIElmIHRoZSBkaXN0aW5jdGlvbiBiZXR3ZWVuIHNvdXJjZSBhbmQgdGFyZ2V0IGlzIG1lYW5pbmdmdWwsIHRoZSBuZXR3b3JrIGlzICoqZGlyZWN0ZWQqKi4gSWYgdGhlIGRpc3RpbmN0aW9uIGlzIG5vdCBtZWFuaW5nZnVsLCB0aGUgbmV0d29yayBpcyAqKnVuZGlyZWN0ZWQqKiAobW9yZSBvbiB0aGF0IGxhdGVyKS4gU28sIGV2ZXJ5IHJvdyB0aGF0IGNvbnRhaW5zIHRoZSBJRCBvZiBvbmUgZWxlbWVudCBpbiBjb2x1bW4gMSwgYW5kIHRoZSBJRCBvZiBhbm90aGVyIGVsZW1lbnQgaW4gY29sdW1uIDIgaW5kaWNhdGVzIHRoYXQgYSBjb25uZWN0aW9uIGJldHdlZW4gdGhlbSBleGlzdHMuIEFuIGVkZ2UgbGlzdCBjYW4gYWxzbyBjb250YWluIGFkZGl0aW9uYWwgY29sdW1ucyB0aGF0IGRlc2NyaWJlICoqYXR0cmlidXRlcyoqIG9mIHRoZSBlZGdlcyBzdWNoIGFzIGEgbWFnbml0dWRlIGFzcGVjdCBmb3IgYW4gZWRnZS4gSWYgdGhlIGVkZ2VzIGhhdmUgYSBtYWduaXR1ZGUgYXR0cmlidXRlIHRoZSBncmFwaCBpcyBjb25zaWRlcmVkICoqd2VpZ2h0ZWQqKiAobW9yZSBvbiB0aGF0IGxhdGVyKS4gQmVsb3cgYW4gZXhhbXBsZSBvZmEgbWluaW1hbCBlZGdlIGxpc3QgY3JlYXRlZCB3aXRoIHRoZSBgdGliYmxlKClgIGZ1bmN0aW9uLg0KDQpgYGB7ciBlZGdlbGlzdHN9DQplZGdlX2xpc3QgPC0gdGliYmxlKGZyb20gPSBjKDEsIDIsIDIsIDMsIDQpLCB0byA9IGMoMiwgMywgNCwgMiwgMSkpDQplZGdlX2xpc3QNCmBgYA0KDQpTb21ldGltZXMgaXQgaXMgcHJlZmVyYWJsZSB0byBhbHNvIGNyZWF0ZSBhIHNlcGFyYXRlIG5vZGUgbGlzdC4gQXQgaXRzIHNpbXBsZXN0LCBhICoqbm9kZSBsaXN0KiogaXMgYSBkYXRhIGZyYW1lIHdpdGggYSBzaW5nbGUgY29sdW1uIC0gd2hpY2ggSSB3aWxsIGxhYmVsIGFzICJpZCIgLSB0aGF0IGxpc3RzIHRoZSBub2RlIElEcyBmb3VuZCBpbiB0aGUgZWRnZSBsaXN0LiBUaGUgYWR2YW50YWdlIG9mIGNyZWF0aW5nIGEgc2VwYXJhdGUgbm9kZSBsaXN0IGlzIHRoZSBhYmlsaXR5IHRvIGFkZCBhdHRyaWJ1dGUgY29sdW1ucyB0byB0aGUgZGF0YSBmcmFtZSBzdWNoIGFzIHRoZSBuYW1lcyBvZiB0aGUgbm9kZXMgb3IgYW55IGtpbmQgb2YgZ3JvdXBpbmdzLg0KDQpgYGB7ciBub2RlbGlzdHN9DQpsaWJyYXJ5KHRpZHl2ZXJzZSkNCm5vZGVfbGlzdCA8LSB0aWJibGUoaWQgPSAxOjQsIGdyb3VwID0gc2FtcGxlKGxldHRlcnNbMToyXSwgNCwgcmVwbGFjZSA9IFRSVUUpKQ0Kbm9kZV9saXN0DQpgYGANCg0KIyMjIyBBZGphY2VuY3kgTWF0cml4DQoNCkEgc2Vjb25kIHBvcHVsYXIgZm9ybSBvZiBuZXR3b3JrIHJlcHJlc2VudGF0aW9uIGlzIHRoZSAqKmFkamFjZW5jeS1tYXRyaXgqKiAoYWxzbyBjYWxsZWQgKipzb2Npby1tYXRyaXgqKikuIEl0IGlzIHJlcHJlc2VudGVkIGFzIGEgJG4qbiQgbWF0cml4LCB3aGVyZSAkbiQgc3RhbmRzIGZvciB0aGUgbnVtYmVyIG9mIGVsZW1lbnRzIG9mIHdoaWNoIHRoZWlyIHJlbGF0aW9uc2hpcHMgc2hvdWxkIGJlIHJlcHJlc2VudGVkLiBUaGUgdmFsdWUgaW4gdGhlIGNlbGwgdGhhdCBpbnRlcmNlcHRzIHJvdyAkbiQgYW5kIGNvbHVtbiAkbSQgaW5kaWNhdGVzIGlmIGFuIGVkZ2UgaXMgcHJlc2VudCAoPTEpIG9yIGFic2VudCAoPTApLg0KDQpUaXA6IEdpdmVuIGFuIGVkZ2VsaXN0LCBhbiBhZGphY2VuY3kgbWF0cml4IGNhbiBlYXNpbHkgYmUgcHJvZHVjZWQgYnkgY3Jvc3N0YWJ1bGF0aW5nOg0KDQpgYGB7ciBtYXRyaXh9DQphZGpfbWF0cml4IDwtIHRhYmxlKGVkZ2VfbGlzdCkgJT4lIGFzLm1hdHJpeCgpDQphZGpfbWF0cml4DQpgYGANCg0KIyMjIyBHZW5lcmF0aW5nIGEgR3JhcGggT2JqZWN0IGluIGBpZ3JhcGhgDQoNClRvIGNyZWF0ZSBhbiBgaWdyYXBoYCBvYmplY3QgZnJvbSBhbiBlZGdlLWxpc3QgZGF0YSBmcmFtZSB3ZSBjYW4gdXNlIHRoZSBgZ3JhcGhfZnJvbV9kYXRhX2ZyYW1lKClgIGZ1bmN0aW9uLCB3aGljaCBpcyBhIGJpdCBtb3JlIHN0cmFpZ2h0IGZvcndhcmQgdGhhbiBgbmV0d29yaygpYC4gVGhlcmUgYXJlIHRocmVlIGFyZ3VtZW50cyBpbiB0aGUgYGdyYXBoX2Zyb21fZGF0YV9mcmFtZSgpYCBmdW5jdGlvbjogZCwgdmVydGljZXMsIGFuZCBkaXJlY3RlZC4gSGVyZSwgZCByZWZlcnMgdG8gdGhlIGVkZ2UgbGlzdCwgdmVydGljZXMgdG8gdGhlIG5vZGUgbGlzdCwgYW5kIGRpcmVjdGVkIGNhbiBiZSBlaXRoZXIgYFRSVUVgIG9yIGBGQUxTRWAgZGVwZW5kaW5nIG9uIHdoZXRoZXIgdGhlIGRhdGEgaXMgZGlyZWN0ZWQgb3IgdW5kaXJlY3RlZC4gQnkgZGVmYXVsdCwgYGdyYXBoLmRhdGEuZnJhbWUoKWAgdHJlYXRzIHRoZSBmaXJzdCB0d28gY29sdW1ucyBvZiB0aGUgZWRnZSBsaXN0IGFuZCBhbnkgcmVtYWluaW5nIGNvbHVtbnMgYXMgZWRnZSBhdHRyaWJ1dGVzLg0KDQpgYGB7ciBpZ3JhcGggb2JqZWN0fQ0KbGlicmFyeShpZ3JhcGgpDQpnIDwtIGdyYXBoX2Zyb21fZGF0YV9mcmFtZShkID0gZWRnZV9saXN0LCB2ZXJ0aWNlcyA9IG5vZGVfbGlzdCwgZGlyZWN0ZWQgPSBGQUxTRSkNCmcNCmBgYA0KDQpMZXRzIGluc3BlY3QgdGhlIHJlc3VsdGluZyBvYmplY3QuIEFuIGBpZ3JhcGhgIGdyYXBoIG9iamVjdCBzdW1tYXJ5IHJldmVhbHMgc29tZSBpbnRlcmVzdGluZyBpbmZvcm1hdGlvbnMuDQoNCiogRmlyc3QsIGl0IHRlbGxzIHVzIHRoZSBncmFwaC10eXBlOiB1bmRpcmVjdGVkIGBVTmAsIG9yICBkaXJlY3RlZCBgRE5gDQoqIEFmdGVyd2FyZHMsIHRoZSBudW1iZXIgb2Ygbm9kZXMgKDQpLCBhbmQgZWRnZXMgKDYpDQoqIEZvbGxvd2VkIGJ5IHRoZSBub2RlIGF0dHJpYnV0ZXMgKG5vZGUgbGV2ZWwgdmFyaWFibGVzKSwgd2hpY2ggaW4gdGhpcyBjYXNlIGFyZSBvbmx5IHRoZWlyIG5hbWUgKGBhdHRyOiBuYW1lICh2L2MpYCkNCiogTGFzdGx5LCBhIGxpc3Qgb2YgYWxsIGV4aXN0aW5nIGVkZ2VzLiBOb3RlOiBgbi0tbWAgaW5kaWNhdGVzIGFuIHVuZGlyZWN0ZWQsIGBuLT5tYCBhbiBkaXJlY3RlZCBlZGdlLg0KDQpMZXRzIHRha2UgYSBsb29rIGF0IHRoZSBzdHJ1Y3R1cmUgb2YgdGhlIG9iamVjdDoNCg0KYGBge3J9DQpnbGltcHNlKGdbWzFdXSkNCmBgYA0KDQpXZSBzZWUsIHRoZSBvYmplY3QgaGFzIGEgbGlzdC1mb3JtYXQsIGNvbnNpc3Rpbmcgb2Ygc2VwcGVyYXRlIGxpc3RzIGZvciBldmVyeSBub2RlLCBjb250YWluaW5nIHNvbWUgYXR0cmlidXRlcyB3aGljaCBhcmUgaXJyZWxldmFudCBub3csIGFuZCBhbiBlZGdlbGlzdCBmb3IgZXZlcnkgbm9kZSwgY2FwdHVyaW5nIGl0cyBlZ28tbmV0d29yayAoZWcuLCBgLi4gLi4tIGF0dHIoKiwgIm5hbWVzIik9IGNociBbMToyXSAiMiIgIjQiYCkNCg0KV2UgY2FuIGFsc28gcGxvdCBpdCB0byB0YWtlIGEgbG9vay4gYGlncmFwaGAgb2JqZWN0IGNhbiBiZSBkaXJlY3RseSB1c2VkIHdpdGggdGhlIGBwbG90KClgIGZ1bmN0aW9uLiBUaGUgcmVzdWx0cyBjYW4gYmUgYWRqdXN0ZWQgd2l0aCBhIHNldCBvZiBwYXJhbWV0ZXJzIHdlIHdpbGwgZGlzY292ZXIgbGF0ZXIuIEl0J3Mgbm90IHN1cGVyIHByZXR0eSwgdGhlcmVmb3JlIHdlIHdpbGwgbGF0ZXIgYWxzbyBleHBsb3JlIG1vcmUgcG93ZXJmdWxsIHBsb3R0aW5nIHRvb2xzIGZvciByZ2FwaHMuIEhvd2V2ZXIsIGl0cyBxdWljayZkaXJ0eSwgc28gbGV0cyB0YWtlIGl0IGxpa2UgdGhhdCBmb3Igbm93Lg0KDQpgYGB7cn0NCnBsb3QoZykNCmBgYA0KDQpZZWFoLCB0aGF0J3MgdGhlIGdyYXBoLiBXZSAgV2UgY2FuIGFsc28gdXNlIHRoZSBhZGphY2VuY3kgbWF0cml4IHRvIGNyZWF0ZSB0aGUgc2FtZSBncmFwaC4NCg0KDQpgYGB7cn0NCmcgPC0gZ3JhcGhfZnJvbV9hZGphY2VuY3lfbWF0cml4KGFkal9tYXRyaXgsIG1vZGUgPSAidW5kaXJlY3RlZCIpDQpnDQpgYGANCg0KV2UgY2FuIGluc3BlY3QgYW5kIG1hbmlwdWxhdGUgdGhlIG5vZGVzIHZpYSBgVihnKWAgKFYgZm9yIHZlcnRpY2VzLCBpdHMgZ3JhcGgtdGhlb3J5IHNsYW5nKSwgYW5kIGVkZ2VzIHdpdGggYEUoZylgDQoNCmBgYHtyfQ0KVihnKQ0KRShnKQ0KYGBgDQoNCldlIGNhbiBhbHNvIHVzZSBtb3N0IG9mIHRoZSBiYXNlLVIgc2xpY2luZyZkaWNpbmcuDQoNCmBgYHtyfQ0KVihnKVsxOjNdDQpFKGcpWzI6NF0NCmBgYA0KDQpSZW1lbWJlciwgaXQncyBhIGxpc3Qtb2JqZWN0LiBTbywgaWYgd2UganVzdCB3YW50IHRvIGhhdmUgdGhlIHZhbHVlcywgd2UgaGF2ZSB0byB1c2UgdGhlIGRvdWJsZSBicmFja2V0IGBbW3hdXWAuIA0KDQpgYGB7cn0NClYoZylbWzE6M11dDQpgYGANCg0KV2UgY2FuIGFsc28gdXNlIHRoZSBgJGAgbm90YXRpb24uDQoNCmBgYHtyfQ0KVihnKSRuYW1lDQpgYGANCg0KIyBOZXR3b3JrcyBhcmUgY29taW5nLi4uDQoNCiMjIEJ1aWxkIHRoZSBncmFwaA0KDQpgYGB7cn0NCnJtKGxpc3Q9bHMoKSkNCg0KZmlsZXMgPC0gbGlzdC5maWxlcyhwYXRoID0iLi4vZGF0YS9Hb1QvIiwgZnVsbC5uYW1lcyA9IFRSVUUpDQpmaWxlcw0KYGBgDQoNCmBgYHtyfQ0KZWRnZXMuY29vYy5hbGwgPC0gZnJlYWQoZmlsZXNbMV0sIGRhdGEudGFibGUgPSBGQUxTRSkgDQpoZWFkKGVkZ2VzLmNvb2MuYWxsKQ0KYGBgDQoNClNvLCB0aGF0J3Mgd2hhdCB3ZSBoYXZlLCBhIGNsYXNzaWNhbCBlZGdlbGlzdCwgd2l0aCBpZDEgaW4gY29sdW1uIDEgYW5kIGlkMiBpbiBjb2x1bW4yLiBOb3RlLCB0aGUgZWRnZXMgYXJlIGluIHRoaXMgY2FzZSB3ZWlnaHRlZC5JIGRvbid0IGxpa2UgdGhlIHNlcHBlcmF0aW5nICItIiBiZXR3ZWVuIGluIHRoZSBuYW1lcywgbGV0cyBnZXQgcmlkIG9mIHRoZW0uIA0KDQpgYGB7cn0NCmNvbG5hbWVzKGVkZ2VzLmNvb2MuYWxsKSA8LSB0b2xvd2VyKGNvbG5hbWVzKGVkZ2VzLmNvb2MuYWxsKSkNCmVkZ2VzLmNvb2MuYWxsICU8PiUNCiAgbXV0YXRlKHNvdXJjZSA9IGdzdWIoIi0iLCAiICIsIHNvdXJjZSksDQogICAgICAgICB0YXJnZXQgPSBnc3ViKCItIiwgIiAiLCB0YXJnZXQpKSANCmBgYA0KT2ssIGxldHMgc2VlIGhvdyBtYW55IGNoYXJhY3RlcnMgd2UgaGF2ZSBvdmVyYWwuDQoNCmBgYHtyfQ0KZWRnZXMuY29vYy5hbGwgJT4lDQogIHNlbGVjdCgtdHlwZSkgJT4lDQogIGdhdGhlcih4LCBuYW1lLCBzb3VyY2U6dGFyZ2V0KSAlPiUgDQogIG5fZGlzdGluY3QoLiRuYW1lKQ0KYGBgDQoNCg0KDQpgYGB7cn0NCmNoYXJzLm1haW4gPC0gZWRnZXMuY29vYy5hbGwgJT4lDQogIHNlbGVjdCgtdHlwZSkgJT4lDQogIGdhdGhlcih4LCBuYW1lLCBzb3VyY2U6dGFyZ2V0KSAlPiUNCiAgZ3JvdXBfYnkobmFtZSkgJT4lDQogIHN1bW1hcmlzZShzdW1fd2VpZ2h0ID0gc3VtKHdlaWdodCkpICU+JQ0KICB1bmdyb3VwKCkgJT4lDQogIGFycmFuZ2UoZGVzYyhzdW1fd2VpZ2h0KSkgJT4lDQogIHRvcF9uKDUwKQ0KDQpoZWFkKGNoYXJzLm1haW4pDQpgYGANCg0KU28gZmFyIHNvIGdvb2QsIGlmIHdlIG9ubHkgZ28gYnkgZWRnZSB3ZWlnaHRzLCBUeXJpb24gaXMgZ29pbmcgdG8gbWFrZSBpdC4uLi4gbXkgZmF2b3JpdGUgYW55aG93Li4uDQoNCkhvd2V2ZXIsIGxldHMgcmVkdWNlIG91ciBlZGdlbGlzdCB0byB0aGlzIG1haW4gY2hhcmFjdGVycywganVzdCB0byB3YXJtIHVwIGFuZCBrZWVwIHRoZSBvdmVydmlldy4NCg0KYGBge3J9DQplZGdlcy5jb29jIDwtIGVkZ2VzLmNvb2MuYWxsICU+JQ0KICBmaWx0ZXIoc291cmNlICVpbiUgY2hhcnMubWFpbiRuYW1lICYgdGFyZ2V0ICVpbiUgY2hhcnMubWFpbiRuYW1lKSAlPiUNCiAgc2VsZWN0KHNvdXJjZSwgdGFyZ2V0LCB3ZWlnaHQpDQpgYGANCg0KDQpgYGB7cn0NCmcgPC0gZ3JhcGhfZnJvbV9kYXRhX2ZyYW1lKGQgPSBlZGdlcy5jb29jLCBkaXJlY3RlZCA9IEZBTFNFKQ0KZw0KYGBgDQoNCk5vdGUgdGhhdCB0aGlzIGNvLW9jY3VyZW5jZSBuZXR3b3JrIGlzIHdlaWdodGVkIChudW1iZXIgb2YgY28tb2NjdXJlbmNlKSwgYW5kIHVuZGlyZWN0ZWQNCg0KYGBge3J9DQppc193ZWlnaHRlZChnKQ0KaXNfZGlyZWN0ZWQoZykNCmBgYA0KDQojIyBJbnNwZWN0IHRoZSBncmFwaA0KDQojIyMgT3ZlcmFsIGdyYXBoIGF0dHJpYnV0ZXMNCg0KV2UgYWxyZWFkeSBrbm93IGZyb20gdGhlIHN1bW1hcnksIGJ1dCB3ZSBjYW4gYWxzbyBjb3VudCB0aGUgbnVtYmVyIG9mIG5vZGVzIGFuZCBlZGdlcyBhcyBmb2xsb3dzOg0KDQpgYGB7cn0NCiMgQ291bnQgbnVtYmVyIG9mIGVkZ2VzDQpnc2l6ZShnKQ0KDQojIENvdW50IG51bWJlciBvZiB2ZXJ0aWNlcw0KZ29yZGVyKGcpDQpgYGANCg0KV2UgY2FuIGdpdmUgdGhlIGdyYXBoIGEgZmlyc3QgcGxvdCB0byBzZWUgd2hhdCBoYXBwZW5zIHRoZXJlLiBJdCdzIG5vdCBwcmV0dHksIGJ1dCB3ZSB3aWxsIGZpbmUtdHVuZSBpdCBsYXRlcg0KDQpgYGB7cn0NCnBsb3QoZykNCmBgYA0KDQpXZSBhbHJlYWR5IHNlZSB0aGF0IHNvbWUgbm9kZXMgYXJlIG5vdCBjb25uZWN0ZWQgKGlzb2xhdGVkKSwgc28gbGV0cyBkcm9wIHRoZW0gZm9yIG91ciBuZXR3b3JrIGFuYWx5c2lzLg0KDQpgYGB7cn0NCmcgPC0gZGVsZXRlX2VkZ2VzKGcsIEUoZylbd2VpZ2h0IDwgMjBdKQ0KZyA8LSBkZWxldGVfdmVydGljZXMoZywgZGVncmVlKGcpID09IDApDQpgYGANCg0KDQojIyMgRWRnZXMNCg0KYGBge3J9DQojIEZpbmQgYWxsIGVkZ2VzIHRoYXQgaW5jbHVkZSAiQnJpdHQiDQpFKGcpW1tpbmMoJ0RhZW5lcnlzIFRhcmdhcnllbicpXV0gIA0KDQojIEZpbmQgYWxsIHBhaXJzIHRoYXQgc3BlbmQgNCBvciBtb3JlIGhvdXJzIHRvZ2V0aGVyIHBlciB3ZWVrDQpFKGcpW1t3ZWlnaHQgPj0gMTUwXV0NCmBgYA0KDQoNCmBgYHtyfQ0KaGlzdChFKGcpJHdlaWdodCkNCmBgYA0KDQojIyMgTm9kZXMNCg0KbGV0cyBzZWUgd2hvIGlzIHRoZSBtb3N0IGNlbnRyYWwgZmlndXJlIGluIHRoaXMgbmV0d29yayBvZiBpbnRlcmFjdGlvbnMNCg0KIyMjIyBEZWdyZWUgY2VudHJhbGl0eQ0KYGBge3J9DQpkZWdyZWUoZykgDQp3aGljaC5tYXgoZGVncmVlKGcpKQ0KDQpzdHJlbmd0aChnKQ0Kd2hpY2gubWF4KHN0cmVuZ3RoKGcpKQ0KYGBgDQoNCiMjIyBOZWlnaGJvcmhvb2Qgb2YgYSBOb2RlDQoNCmBgYHtyfQ0KbmVpZ2hib3JzKGcsICdSb2JlcnQgQmFyYXRoZW9uJykNCmBgYA0KDQplZ28gbmV0d29yaw0KDQpgYGB7cn0NCmVnbyhnLCAyLCAiRHJvZ28iKVtbMV1dDQpgYGANCg0KYGBge3J9DQpnLmRyb2dvIDwtIG1ha2VfZWdvX2dyYXBoKGcsIDIsIG5vZGVzID0gIkRyb2dvIilbWzFdXQ0KZy5kYW5ueSA8LSBtYWtlX2Vnb19ncmFwaChnLCAyLCBub2RlcyA9ICJEYWVuZXJ5cyBUYXJnYXJ5ZW4iKVtbMV1dDQpgYGANCg0KYGBge3J9DQpwbG90KGcuZHJvZ28pDQpwbG90KGcuZGFubnkpDQpgYGANCg0KQnR3OiBUbyBtZXJnZSB0d28gZ3JhcGhzLCBqdXN0IGRvOg0KDQpgYGB7cn0NCmcubWVyZ2UgPC0gZy5kcm9nbyArIGcuZGFubnkNCmcubWVyZ2UNCmBgYA0KDQoNCg0KDQojIyMgQmV0d2Vlbm5lc3MgQ2VudHJhbGl0eQ0KDQpgYGB7cn0NCmJldHdlZW5uZXNzKGcpDQpgYGANCg0KIyMjIEVpZ2VudmVjdG9yIENlbnRyYWxpdHkNCg0KYGBge3J9DQplaWdlbl9jZW50cmFsaXR5KGcsIHNjYWxlID0gVFJVRSkkdmVjdG9yICU+JSByb3VuZCgzKQ0KYGBgDQoNCg0KIyMjIGdyYXBoIHN0cnVjdHVyZQ0KDQoNCmBgYHtyfQ0KZWRnZV9kZW5zaXR5KGcpDQpgYGANCg0KDQpgYGB7cn0NCmRpYW1ldGVyKGcsIGRpcmVjdGVkID0gRiwgd2VpZ2h0cyA9IE5BKQ0KYGBgDQoNCg0KYGBge3J9DQp0cmFuc2l0aXZpdHkoZykNCmBgYA0KDQpgYGB7cn0NCm1lYW5fZGlzdGFuY2UoZywgZGlyZWN0ZWQgPSBGKQ0KYGBgDQoNCiMjIFlvdXIgdHVybg0KQWhoLCB5b3Ugc2F3IGl0IGNvbW1pbmcsIHJpZ2h0PyBXaGF0IGFib3V0IHlvdSBleHBsb3JlIHRoZSBHb1QgbmV0d29yayBhIGJpdCBvbiB5b3VyIG93biBbSEVSRV0oaHR0cHM6Ly93d3cua2FnZ2xlLmNvbS9kYW5pZWxoYWluL3Nkcy0yMDE4LW0yLTEtaW50cm8tbnctZXhlcmNpc2UtMSkuIExldHMgc2VlIGhvdyB0aGF0IHdvcmtzIG91dCENCg0KDQoNCg0KIyBEaXJlY3RlZCBOZXR3b3JrcyBhcmUgY29tbWluZy4uLg0KDQpTbyBmYXIgc28gZ29vZCwgdXAgdG8gbm93IHdlIGNvbnNpZGVyZWQgdW5kaXJlY3RlZCBuZXR3b3JrcywgY29uc3RydWN0ZWQgYnkgdGhlIGFtb3VudCBjaGFyYWN0ZXJzIGNvLW9jY3VyLiBIb3dldmVyLCBhcyB5b3UgYWxyZWFkeSBtaWdodCBndWVzcywgdGhhdCdzIG5vdCB3aGVyZSB3ZSBzdG9wLiANCg0KVGhlcmUgYXJlIGFsc28gb3RoZXIgcmVsYXRpb25zaGlwcyB0byB3aGljaCB3ZSBjYW4sIGFuZCBzb21ldGltZXMgaGF2ZSB0bywgYXNzaWduIGEgZGlyZWN0aW9uYWxpdHkuIEFuIG9idmlvdXMgZXhhbXBsZSBoZXJlIGFyZSBmYW1pbHkgdGllcy4gSGVyZSwgSSB3aWxsIG9zZSB0aGUgbmljZWx5IGNvbXBpbGVkIGRhdGFzZXQgb2YgdGhlIHdvbmRlcmZ1bCBbU2hpcmluXShodHRwczovL3NoaXJpbmcuZ2l0aHViLmlvKSB0aGF0IGNhbiBiZSBmb3VuZCBbaGVyZV0oaHR0cHM6Ly9naXRodWIuY29tL1NoaXJpbkcvYmxvZ19wb3N0c19wcmVwL3RyZWUvbWFzdGVyL0dvVCkuIEl0IGNvbnRhaW5zIGEgbm9kZWxpc3Qgd2l0aCBob3VzZS1hZmZpbGlhdGlvbnMgYW5kIGZ1cnRlaHIgY2hhcmFjdGVyaXN0aWNzIG9mIG1haW4gY2hhcmFjdGVycywgYW5kIGEgZWRnZWxpc3Qgb2YgdGhlaXIgZmFtaWx5IHJlbGF0aW9uc2hpcHMuDQoNCg0KYGBge3J9DQpybShjaGFycy5tYWluLCBnLCBnLmRhbm55LCBnLmRyb2dvLCBnLm1lcmdlKQ0KZWRnZXMuZmFtIDwtIHJlYWRSRFMoIi4uL2RhdGEvR29UL3VuaW9uX2VkZ2VzLlJEUyIpDQpub2Rlcy5mYW0gPC0gcmVhZFJEUygiLi4vZGF0YS9Hb1QvdW5pb25fY2hhcmFjdGVycy5SRFMiKQ0KYGBgDQoNCmBgYHtyfQ0KaGVhZChub2Rlcy5mYW0pDQpoZWFkKGVkZ2VzLmZhbSkNCmBgYA0KDQoNCmBgYHtyfQ0KZyA8LSBncmFwaF9mcm9tX2RhdGFfZnJhbWUoZWRnZXMuZmFtLCANCiAgICAgICAgICAgICAgICAgICAgICAgICAgIHZlcnRpY2VzID0gbm9kZXMuZmFtLA0KICAgICAgICAgICAgICAgICAgICAgICAgICAgZGlyZWN0ZWQgPSBUUlVFKQ0KZw0KYGBgDQoNCmBgYHtyfQ0KcGxvdChnKQ0KYGBgDQoNCg0KRm9yIHBsb3R0aW5nIHRoZSBsZWdlbmQsIEkgYW0gc3VtbWFyaXppbmcgdGhlIGVkZ2UgYW5kIG5vZGUgY29sb3JzLg0KDQpgYGB7cn0NCmNvbG9yX3ZlcnRpY2VzIDwtIG5vZGVzLmZhbSAlPiUNCiAgZ3JvdXBfYnkoaG91c2UsIGNvbG9yKSAlPiUNCiAgc3VtbWFyaXNlKG4gPSBuKCkpICU+JQ0KICBmaWx0ZXIoIWlzLm5hKGNvbG9yKSkNCg0KY29sb3JzX2VkZ2VzIDwtIGVkZ2VzLmZhbSAlPiUNCiAgZ3JvdXBfYnkodHlwZSwgY29sb3IpICU+JQ0KICBzdW1tYXJpc2UobiA9IG4oKSkgJT4lDQogIGZpbHRlcighaXMubmEoY29sb3IpKQ0KYGBgDQoNCg0KDQoNCmBgYHtyLCBmaWcud2lkdGg9MTUsIGZpZy5oZWlnaHQ9MTV9DQpwbG90KGcsDQogICAgIGxheW91dCA9IGxheW91dF93aXRoX2ZyKGcpLCAjIGdyYXBoIGxheW91dCwgbW9yZSBvbiB0aGF0IGxhdGVyDQogICAgIHZlcnRleC5sYWJlbCA9IGdzdWIoIiAiLCAiXG4iLCBWKGcpJG5hbWUpLCAjIEp1c3QgYWx0ZXJlZCB0aGUgbGFiZWwgdGhhdCBpdCBpcyBpbiB0d28gbGluZXMNCiAgICAgdmVydGV4LnNoYXBlID0gVihnKSRzaGFwZSwgIyBsb2FkIHRoZSBwcmVkZWZpbmVkIHNoYXBlIG9mIHRoZSBub2RlcyAobWFsZS9mZW1hbGUpDQogICAgIHZlcnRleC5jb2xvciA9IFYoZykkY29sb3IsICMgbG9hZCB0aGUgcHJlZGVmaW5lZCBjb2xvciBvZiB0aGUgbm9kZXMgKGhvdXNlcykNCiAgICAgdmVydGV4LnNpemUgPSAoVihnKSRwb3B1bGFyaXR5ICsgMC41KSAqIDUsICMgZGVmaW5lIG5vZGUtc2l6ZSBieSBwb3B1bGFyaXR5DQogICAgIHZlcnRleC5mcmFtZS5jb2xvciA9ICJncmF5IiwgIyBjb2xvciBvZiB0aGUgZnJhbWUgYXJvdW5kIHRoZSBub2RlDQogICAgIHZlcnRleC5sYWJlbC5jb2xvciA9ICJibGFjayIsICMgY29sb3Igb2YgdGhlIGxhYmVsDQogICAgIHZlcnRleC5sYWJlbC5jZXggPSAwLjgsICMgc2l6ZSBvZiB0aGUgbGFiZWwNCiAgICAgZWRnZS5hcnJvdy5zaXplID0gMC41LCAjIHNpemUgb2YgdGhlIGFycm93DQogICAgIGVkZ2UuY29sb3IgPSBFKGcpJGNvbG9yLCAjIGxhb2QgcHJlZGVmaW5lZCBlZGdlL2NvbG9yIChyZWxhdGlvbnNoaXApDQogICAgIGVkZ2UubHR5ID0gRShnKSRsdHkpICMgRWRnZSBzdHlsZQ0KbGVnZW5kKCJ0b3BsZWZ0IiwgbGVnZW5kID0gYyhOQSwgIk5vZGUgY29sb3I6IiwgYXMuY2hhcmFjdGVyKGNvbG9yX3ZlcnRpY2VzJGhvdXNlKSwgTkEsICJFZGdlIGNvbG9yOiIsIGFzLmNoYXJhY3Rlcihjb2xvcnNfZWRnZXMkdHlwZSkpLCBwY2ggPSAxMCwNCiAgICAgICBjb2wgPSBjKE5BLCBOQSwgY29sb3JfdmVydGljZXMkY29sb3IsIE5BLCBOQSwgY29sb3JzX2VkZ2VzJGNvbG9yKSwgcHQuY2V4ID0gMywgY2V4ID0gMiwgYnR5ID0gIm4iLCBuY29sID0gMSwNCiAgICAgICB0aXRsZSA9ICIiKSANCmxlZ2VuZCgidG9wbGVmdCIsIGxlZ2VuZCA9ICIiLCBjZXggPSAzLCBidHkgPSAibiIsIG5jb2wgPSAxLA0KICAgICAgIHRpdGxlID0gIkdhbWUgb2YgVGhyb25lcyBGYW1pbHkgVGllcyIpDQpgYGANCg0KIyMgQ29tbXVuaXR5IERldGVjdGlvbg0KDQpZb3UgbWlnaHQgaGF2ZSBhbHJlYWR5IGd1ZXNzZWQsIHdlIGNhbiB2ZXJ5IHdlbGwgYWxzbyBkbyBhIGNsdXN0ZXJpbmcgZXhlcmNpc2UgaW4gbmV0d29ya3MuIEhlcmUsIHdlIGRvIG5vdCBjbHVzdGVyIG5vZGVzIGFjY29yZGluZyB0byB0aGVpciBzaW1pbGFyaXR5IGluIGF0dHJpYnV0ZXMsIGJ1dCBhY2NvcmRpbmcgdG8gdGhlaXIgY29ubmVjdGl2aXR5LiBUaGVyZSBhcmUgcGxlbnR5IG9mIGFsZ29yaXRobXMsLCBhbmQgd2Ugd2lsbCBleHBsb3JlIGZ1cnRoZXIgb25lcyBsYXRlcm9uLiBNb3N0IG9mIHRoZW0gYWltIHRvIGZpbmQgY29tbXVuaXRpZXMgd2l0aCBtYXhpbXVtIHdpdGhpbi9jb25uZWN0aXZpdHksIGFuZCBtaW5pbXVtIGJldHdlZW4vY29ubmVjdGl2aXR5Lg0KDQpIb3dldmVyLCBtb3N0IG9mIHRoZW0gYXJlIG5vdCBkZXNpZ25lZCB0byB3b3JrIHdpdGggZGlyZWN0ZWQgbmV0d29ya3MuIFRoZXJlZm9yZSwgd2Ugd2lsbCBjb252ZXJ0IG91ciBuaWNlIG5ldHdvcmsgZm9yIG5vdyB0byBhbiB1bmRpcmVjdGVkIG9uZS4NCg0KYGBge3J9DQpnLnVkIDwtIGFzLnVuZGlyZWN0ZWQoZykNCmBgYA0KDQpGaXJzdCwgd2Ugd2lsbCBnaXZlIGl0IGEgdHJ5IHdpdGggdGhlICoqZWRnZS1iZXR3ZWVubmVzcyoqIGFsZ29yaXRobSAoTmV3bWFuLUdpcnZhbikuIEhlcmUsIGhpZ2gtYmV0d2Vlbm5lc3MgZWRnZXMgYXJlIHJlbW92ZWQgc2VxdWVudGlhbGx5IChyZWNhbGN1bGF0aW5nIGF0IGVhY2ggc3RlcCkgYW5kIHRoZSBiZXN0IHBhcnRpdGlvbmluZyBvZiB0aGUgbmV0d29yayBpcyBzZWxlY3RlZC4NCg0KTGV0cyB0YWtlIGEgbG9vayBob3cgaXQgd29ya3MuDQoNCmBgYHtyfQ0KP2NsdXN0ZXJfZWRnZV9iZXR3ZWVubmVzcw0KYGBgDQoNCkFuZCB3ZSBub3cgcnVuIGl0LiBBcyBhbiBoaXJhcmNoaWNhbCBjb21tdW5pdHkgZGV0ZWN0aW9uIHRlY2huaXF1ZS4gU2luY2UgaXQgaXMgYW4gaGlyYXJjaGljYWwgb25lLCB3ZSBjYW4gYWdhaW4gcGxvdCBhIGRlbmRvZ3JhbSB3aGljaCB3ZSBhbHJlYWR5IGtub3cgZnJvbSB0aGUgaGlyYXJjaGljYWwgY2x1c3RlcmluZw0KDQpgYGB7ciwgZmlnLndpZHRoPTMwLCBmaWcuaGVpZ2h0PTE1fQ0KDQpjZWIgPC0gY2x1c3Rlcl9lZGdlX2JldHdlZW5uZXNzKGcudWQpIA0KZGVuZFBsb3QoY2ViLCBtb2RlPSJoY2x1c3QiKQ0KYGBgDQoNCmBgYHtyLCBmaWcud2lkdGg9MjAsIGZpZy5oZWlnaHQ9MjB9DQpwbG90KGNlYiwgZy51ZCwNCiAgICAgdmVydGV4LmZyYW1lLmNvbG9yID0gVihnKSRjb2xvciwgIyBsb2FkIHRoZSBwcmVkZWZpbmVkIGNvbG9yIG9mIHRoZSBub2RlcyAoaG91c2VzKQ0KICAgICB2ZXJ0ZXguc2l6ZSA9IChWKGcpJHBvcHVsYXJpdHkgKyAwLjUpICogNSAjIGRlZmluZSBub2RlLXNpemUgYnkgcG9wdWxhcml0eSkgDQopDQpgYGANCg0KTGV0cyBvbmx5IHNlZSBob3cgZ29vZCBpdCBwZXJmb3JtcyBvbiB0aGUgbWFqb3IgaG91c2VzLCB0aGUgcmVzdCBpcyB0b28gc21hbGwgYW55aG93DQoNCmBgYHtyfQ0KYmluZF9jb2xzKGNvbSA9IGNlYiRtZW1iZXJzaGlwLCBob3VzZSA9IFYoZy51ZCkkaG91c2UpICU+JQ0KICBncm91cF9ieShob3VzZSkgJT4lDQogIGZpbHRlcihuKCkgPj0gMTApICU+JQ0KICB1bmdyb3VwKCkgJT4lDQogIHRhYmxlKCkNCmBgYA0KDQpXZSBzZWUsIGluZGVlZCwgdGhhdCB0aGUgY29tbXVuaXRpZXMgZm9yIHRoZSBtb3N0IHBhcnQgY2FwdHVyZSB0aGUgYWZmaWxpYXRpb24gdG8gdGhlIGdyZWF0IGhvdXNlcy4NCg0KIyMgWW91ciB0dXJuDQoNCkFHYWluLCBpdHMgdGltZSB0byBoYXZlIHNvbWUgZnVuIG9uIHlvdXIgb3duLiBbSEVSRV0oaHR0cHM6Ly93d3cua2FnZ2xlLmNvbS9kYW5pZWxoYWluL3Nkcy0yMDE4LW0yLTEtaW50cm8tbnctZXhlcmNpc2UtMikgeW91IHdpbGwgZmluZCBhbm90aGVyIGthZ2dsZSBub3RlYm9vayB3aGVyZSB5b3UgY2FuIGRlbW9uc3RyYXRlIHlvdXIgbmV0d29yayBhbmFseXNpcyBza2lsbHMgZXZlbiBtb3JlIQ0KDQo=